home *** CD-ROM | disk | FTP | other *** search
/ PD ROM 1 / PD ROM Volume I - Macintosh Software from BMUG (1988).iso / Programming / Programming Tools / Programming DA's / Comments / Comments Doc next >
Encoding:
Text File  |  1986-04-29  |  2.6 KB  |  42 lines  |  [TEXT/ttxt]

  1. "Comments" is a desk accessory that lets you read, write, or modify
  2. the comments normally found in the Finder's "Get Info" box -- but 
  3. you don't have to return to the Finder to do it!  This short doc
  4. explains two things about the DA that might not be obvious other-
  5. wise:  how to install the (optional) special menu cursor (the file
  6. "Cmnts.crs" that accompanies the accessory; and the slightly non-
  7. standard but, I think, amusing user interface it uses.
  8. 1.  Installation:  you install or remove "Comments" as you would 
  9. any other desk accessory.  You may,
  10. if you wish, use ResEdit to install also (into the System file)
  11. the cursor resource called "Cmnts.crs"; the DA will work fine
  12.  without it, however. Its resource ID is 5; so if you do install 
  13. it, be sure you don't already have a cursor resource with this 
  14. ID# (most Systems have just the standard 4).
  15. 2.  Use:  The DA window has a light grey background and a white
  16. rectangle within it where comments appear and are modified by
  17. you.  When you move the mouse over this rectangle, the cursor is
  18. the I-beam shape, meaning you can edit the text appearing in the
  19. rectangle.  When the cursor is outside the white rectangle but
  20. within the DA's window, it changes shape (to a miniature menu if
  21. you installed "Cmnts.crs", otherwise to a cross).  Mouse down now
  22. and a menu pops up where the mouse was clicked (thanks to Mike
  23. Schuster: see MacTutor vol 1 #12)!  Choose "Comment" from the menu
  24. to get a list of all the files, both applications and documents,
  25. on any mounted disk -- this is just your basic SFGetFile dialog 
  26. box.  Pick a file, and if there's a comment appended it will
  27. appear in the DA window's white rectangle.  You can now modify it;
  28. if the file had no comment you'll only see TextEdit's flashing
  29. vertical bar.  You can type a new comment if you wish.  In either
  30. case (modifying an old comment or adding a new one), you need to
  31. pop up the menu and choose "Save" to associate the new comment 
  32. with the file.  Choose "Comment" again to see another file.
  33. 3.  One last caveat:  this version won't work with any Finder later
  34. than 4.1, meaning no HD20's, Mac+s, or other HFS systems need apply.
  35. When I get plussed (RSN I hope) I will post a version that will work
  36. with both MFS and HFS systems.
  37. 4.  I've tested "Comments" with most of my commonly used applications,
  38. and with TMON's Trap Discipline and Heap Scramble routines.  It seems
  39. solid, but...I am an amateur programmer, so please exercise prudence
  40. and get to know the thing before you entrust valuable data to it.
  41. If you have any problems or comments, please leave me E-mail at
  42. 70277.726.              Enjoy, Carlos Weber